home *** CD-ROM | disk | FTP | other *** search
/ Power CD / Power CD ATARI-Rechner Lieben.iso / UTILITY / EGALE / EGALE.DOC next >
Encoding:
Text File  |  1993-10-08  |  26.7 KB  |  643 lines
  1. ---------------------------------------------------------------------
  2.          Égale - das Werkzeug zum komfortablen Dateivergleich
  3.                       (C) 1993 by David Reitter
  4.        Égale ist Shareware und darf unverändert kopiert werden.
  5. ---------------------------------------------------------------------
  6.                          Version 1.1 vom 9.10.93
  7. =====================================================================
  8.  
  9.  
  10.  
  11.                                 Anleitung
  12.                    -----------------------------------
  13.  
  14.  
  15.  
  16.  
  17.  
  18.  
  19.  
  20.  
  21.  
  22.  
  23.  
  24.  
  25.  
  26. _____________________________________________________________________
  27.  
  28. ***** Inhalt
  29.       ------
  30.  
  31. 1.    Einleitung
  32. 1.1   Wozu Égale ?
  33. 1.2   Die Möglichkeiten im Überblick
  34. 1.3   Die Égale-Grundversion ist frei kopierbar
  35. 1.4   Wie entstand Égale ?
  36. 2.    Beschreibung aller Funktionen
  37. 2.1   Laden von Dateien
  38. 2.2   Befehle zur Anzeigesteuerung
  39. 2.3   Das Menü "Suchen"
  40. 2.3.1 suchen
  41. 2.3.2 springen
  42. 2.3.3 Der Zeilenabgleich
  43. 2.3.4 Der automatische Zeilenabgleich
  44. 2.3.5 gesuchtes finden
  45. 2.4   Zeilenbearbeitung
  46. 2.5   Abspeichern der Optionen
  47. 2.6   Fensterhandling
  48. 3.    Start von Égale
  49. 3.1   Parameterübergabe
  50. 4.    Tips zur Benutzung
  51. 5.    Sonstiges
  52.  
  53. _____________________________________________________________________
  54.  
  55.  
  56. ***** 1. Einleitung
  57.  
  58. 1.1 Wozu Égale?
  59.  
  60. Zwei Situationen aus dem Programmierer-Alltag:
  61.  
  62. Wie oft passiert es, daß man eine Textdatei o.ä. plötzlich mehrfach
  63. auf verschiedenen Disketten, Partitionen oder Ordnern entdeckt und
  64. nicht mehr weiß, welche der Dateien die aktuellste war. Das Datei-
  65. datum ist nicht immer ein verläßlicher Hinweis, denn es kann beim
  66. Kopieren geändert worden sein oder durch ein falsch gesetztes System-
  67. datum auf einen alten Wert gesetzt worden sein.
  68.   Vielleicht ist man aber auch daran interessiert, die Unterschiede
  69. zwischen verschiedenen Dateien herauszufinden, da sich z.B. bei der
  70. letzten Änderung ein Fehler eingeschlichen hat, den man nicht sofort
  71. lokalisieren kan.
  72.  
  73. Oder:
  74. Sie haben ein Programm entwickelt, das bereits richtige Ergebnisse
  75. lieferte, und haben dies durch eine Reihe von Referenzbeispielen
  76. bestätigt. Bei der Weiterentwicklung wollen Sie nun sicher sein, daß
  77. keine neuen Fehler eingebaut werden und die bisherigen Ergebnisse
  78. reproduziert werden. Um das zu gewährleisten, müssen Sie alle Refe-
  79. renzbeispiele erneut durchrechnen und mit den ursprünglich erhal-
  80. tenen Ergebnissen vergleichen. Eine Zeitraubende und mühevolle Ar-
  81. beit.
  82.  
  83. Für jeden, der schon einmal mit diesen oder ähnlichen Problemen kon-
  84. frontiert worden ist, bietet Égale die Lösung. Natürlich ist Égale 
  85. genauso geeignet für Nicht-Programmierer, die Tabellen oder Texte 
  86. vergleichen wollen.
  87.  
  88. Zwar kann man im Prinzip derartige Aufgaben auch mit jedem belie-
  89. bigen Texteditor lösen (vorausgesetzt, daß er zwei Textpuffer und
  90. zwei Fenster bietet), jedoch fehlt dabei dann jegliche Unterstüt-
  91. zung für das spezielle Problem (zumindest ist uns kein Editor be-
  92. kannt, der das leistet) und die Suche nach Unterschieden bleibt eine
  93. nervtötende Arbeit, die alle Konzentration erfordert.
  94.  
  95.  
  96. 1.2 Die Möglichkeiten im Überblick
  97.  
  98. - Égale lädt immer zwei Dateien pro Fenster und stellt sie par-
  99.   allel (nebeneinander) im senkrecht geteilten Fenster dar.
  100. - Égale kann beliebig große Dateien mit beliebig vielen Zeilen
  101.   einlesen, der Arbeitsspeicher stellt wie immer eine entscheidende
  102.   Grenze dar...
  103. - Es können sowohl Textdateien als auch Binärdateien verglichen werden
  104. - Sie können sich in den Dateien vor und zurück bewegen.
  105. - Sie können die Aufteilung des Fensters frei bestimmen.
  106. - Mit einer Reihe von Hilfsfunktionen wird Ihnen das Aufspüren der
  107.   Unterschiede leicht gemacht.
  108. - Die Zeilennumerierung (abschaltbar) erleichtert die Orientierung.
  109. - Der Vergleich erfolgt entweder zeichenweise oder durch Interpreta-
  110.   tion jeder Zeile als numerischen Wert (für Ausgabedateien von
  111.   Rechenprogrammen).
  112. - Beim numerischen Vergleich kann eine Fehlertoleranz vorgegeben
  113.   werden, innerhalb derer die beiden Werte als 'gleich' angesehen
  114.   werden.
  115. - Eine Text-Suchfunktion ist vorhanden.
  116. - Sie können zu jeder beliebigen Zeile des Textes durch Eingabe der
  117.   Zeilennummer (relativ oder absolut) springen.
  118. - Die HELP-Taste zeigt Ihnen alle Tastenfunktionen an.
  119. - Égale ist komplett in GEM eingebunden und läuft auf ST, TT und
  120.   F030 und unter Multitasking-System unter TOS.
  121.  
  122.  
  123. 1.3 Égale ist frei kopierbar
  124.  
  125. Égale dürfen Sie frei kopieren, in Mailboxen uploaden, Freunden
  126. weitergeben etc. Auch darf Égale in PD-Serien aufgenommen werden,
  127. sofern ich schriftlich informiert werde. Égale und die dazugehörigen 
  128. Dateien dürfen aber in keinem Falle verändert werden und müssen alle 
  129. (d.h. EGALE.PRG, EGALE.RSC und EGALE.DOC) vollständig mitgeliefert 
  130. werden. In Paketen (Mailboxen) dürfen sich ohne meine schriftliche 
  131. Zustimmung keine weiteren Pakete befinden.
  132.  
  133. Égale ist aber Shareware. Wenn Sie Égale benutzen möchten, müssen
  134. Sie sich registrieren lassen. Dies geschieht durch die Eingabe eines
  135. Paßwortes, das abhängig von Ihrem Namen und Wohnort ist. Sie
  136. erhalten diesen Schlüssel vom Programmierer.
  137.   Durch Eingabe dieses Schlüssel machen Sie Ihr Égale zu einer
  138. registrierten Version.
  139.   Die öffentliche enthält alle für einen komfortablen Dateivergleich
  140. nötigen Befehle und Funktionen. Doch so richtig Spaß macht es, wenn
  141. man das registrierte Égale besitzt.
  142.   Daß die Registrierung etwas kostet, haben Sie sich sicher schon ge-
  143. dacht. Aber wohl nicht, daß sie nur 10 DM kostet !
  144.  
  145.   Wie kommt man nun an "seinen" Schlüssel heran ? Kein Problem.
  146.  
  147. In jedem Fall benötige ich
  148. - Ihren Namen
  149. - Ihre Postleitzahl
  150. - Den Namen Ihres Wohnorts  
  151.   
  152. Es gibt 2 Möglichkeiten:
  153.  
  154. 1. Per E-Mail
  155. Verfügen Sie über ein Modem und können Sie mir eine Mail ins MausNet
  156. schreiben, schicken Sie mir eine PM an
  157.         David Reitter @ WI2
  158.         (david_reitter@wi2.maus.de)
  159. und überweisen Sie mir 10 DM.
  160. Sie erhalten umgehend einen passenden Schlüssel per E-Mail.
  161.  
  162. 2. Per Post
  163. Schicken Sie mir
  164. - einen 10 DM-Schein
  165. - Ihre Daten (s.o.)
  166. - einen ausreichend frankierten Rückumschlag.
  167. Den Schlüssel erhalten Sie postwendend.
  168. Wichtig: Fehlt irgendwas, kommt nichts zurück...
  169.  
  170. Den erhaltenen Schlüssel geben Sie im Registrierungsdialog ein, den 
  171. Sie erreichen, wenn Sie ^A drücken (Dialog "Über Égale"), "Info" 
  172. anklicken und jetzt mit dem Button "Registrierung" den 
  173. Registrierungsdialog aufrufen.
  174.  
  175.  
  176.                           Hier die Bankverbindung:
  177.                         ----------------------------
  178.                         | David Reitter            |
  179.                         | KTO: 0229 773            |
  180.                         | BLZ: 550 700 40          |
  181.                         |      Deutsche Bank Mainz |
  182.                         ----------------------------
  183.  
  184.                             Und meine Adresse:
  185.                             -----------------
  186.                             | David Reitter |
  187.                             | Albinistr. 10 |
  188.                             | D-55116 Mainz |
  189.                             -----------------
  190.  
  191.  
  192. Wer sich registrieren läßt, erklärt sich damit einverstanden, daß
  193. seine Daten gespeichert werden.
  194.  
  195. Wer registrierter Benutzer ist, kann mir jederzeit einen frankierten
  196. Rückumschlag und eine Diskette schicken, um die neuste Version von
  197. Égale zu erhalten, sofern die Version nicht gesondert vertrieben wird.
  198.  
  199.  
  200. 1.4 Wie entstand Égale ?
  201.  
  202. Ursprünglich stammt Égale von Christof Schardt. Damals hieß das Pro-
  203. gramm noch COMPARE und war nicht in GEM eingebunden, lief also nur
  204. unter ST-High. Anfang 1993 wurde COMPARE komplett neuprogrammiert
  205. und dabei in GEM eingebunden. Es heißt nun "Égale".
  206.   Warum "Égale" ?  "égal" heißt auf französisch "gleich", "égale"
  207. ist die weibliche Form. Warum sollten auch alle Programme irgendwelche 
  208. englischen Namen tragen ???
  209.  
  210.  
  211. |-------------------------- Die Programmierer: --------------------------|
  212. |                                                                        |
  213. | David Reitter                        Christof Schardt                  |
  214. | (Programmierung, GEM, Konzept)       (Idee, Ursprung, viele Tips etc.) |
  215. | Albinistr. 10                        Kinzigweg 1                       |
  216. | 55116 Mainz                          64297 Darmstadt                   |
  217. | Tel.: -49-6131-233255                                                  |
  218. |------------------------------- E-Mail: --------------------------------|
  219. | David Reitter @ WI2                  Christof Schardt @ F              |
  220. | (Mausnetz)                           (Mausnetz)                        |
  221. |                                                                        |
  222. ¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯
  223.  
  224. Égale erklärt sich dank GEM-Bedienung eigentlich von selber. Dadurch
  225. fällt es um so schwerer, in dieser Anleitung alles leicht verständ-
  226. lich zu erklären. Anstatt einer Auflistung aller Menüpunkte ist die
  227. Anleitung in Sinnabschnitte geteilt.
  228.  
  229. _____________________________________________________________________
  230.  
  231. ***** 2. Beschreibung aller Funktionen
  232.  
  233. 2.1 Laden von Dateien
  234.  
  235. Mit dem Menüpunkt "File"/"Öffnen" läßt sich ein neues Fenster öffnen.
  236. Hierfür werden zwei Dateien benötigt. Es erscheint die Fileselektor-
  237. box.
  238.  
  239. Wenn Égale (ohne Kommandozeile) gestartet wurde, wird dieser Menü-
  240. punkt quasi automatisch ausgeführt.
  241.  
  242. Ein zweiter Menüpunkt zum Öffnen von Dateien ist "Binäre öffnen". 
  243. Hiermit werden auch zwei Dateien geladen, diese werden aber als 
  244. Binärdateien interpretiert und angezeigt. Das bedeutet, daß immer 
  245. nur ein Byte pro Zeile angezeigt wird, dieses aber in verschiedenen 
  246. Darstellungsformen. (Vorsicht: Die Datei wird im Speicher dann 5mal 
  247. so lang !) Bedingt durch die Logik sind beim Binärvergleich einige 
  248. Funktionen nicht verfügbar. Sie erscheinen in Dialogen grau (nicht 
  249. wählbar).
  250.  
  251. Es erscheint ein Fileselektor, indem Sie eine Datei wählen können.
  252.  
  253. Sie können auch Wildcards in den Dateinamen angeben: Wenn Sie z.B.
  254.  
  255. DATEI?.TXT
  256.  
  257. anwählen und zwei passende Dateien existieren, erscheint nur ein
  258. Fileselektor und die ersten zwei passenden Dateien werden geladen. In
  259. diesem Falle wären das z.B. DATEI1.TXT und DATEI2.TXT.
  260.  
  261. Benutzen Sie Selectric (TM), können Sie hier mehrere Files angeben !
  262.  
  263. Sie können also durch den ersten Fileselektor gleich zwei Dateien 
  264. laden lassen. Wurde bloß eine Datei gefunden, erscheint noch ein 
  265. Fileselektor zur Auswahl der zweiten Datei.
  266.  
  267. Ist nicht genügend Speicher für eine der zu ladenden Datei frei oder
  268. tritt ein anderer Fehler auf, wird dieser gemeldet und das Öffnen ab-
  269. gebrochen.
  270.  
  271. Ansonsten werden die Dateien geladen und in einem neugeöffnetem
  272. Fenster dargestellt.
  273.  
  274. Man kann mehrere Fenster gleichezeitig öffnen. Klickt man in das Feld
  275. links oben am Fenster - auf den Closer - wird das Fenster wieder ge-
  276. schlossen.
  277.  
  278.  
  279. 2.2 Befehle zur Anzeigesteuerung
  280.  
  281. Sehr wichtig ist es ja, Unterschiede bzw. Gleiches schnell erkennen
  282. zu können und sich dabei gut in der Datei orientieren zu können.
  283.  
  284. Entscheidend für den Dateivergleich ist, welche Zeilen man suchen
  285. möchte: Man kann entweder Übereinstimmungen oder Unterschiede zwischen
  286. beiden Dateien suchen. Dies kann man im Dialog "Vergleichsmodus", zu
  287. erreichen über den gleichnamigen Menüpunkt im Optionen-Menü, einstellen.
  288.   Allgemein hebt Égale die gesuchten Zeilen automatisch hervor.
  289.  
  290. -> Dieser Dialog ist nur erreichbar, wenn Égale registriert wurde.
  291.    Ansonsten wird immer nach Unterschieden gesucht; die Zeilen
  292.    werden als Strings verglichen.
  293.  
  294.  
  295. Égale bietet die Möglichkeit, die Zeilen auch als Zahlen zu betrach-
  296. ten und dann die Zahlen zu vergleichen. Auch diese Einstellungen können
  297. Sie im "Vergleichsmodus"-Dialog tätigen. Hier können Sie auswählen, ob die
  298. Zeilen als Zahlen verglichen werden sollen und einen Prozentsatz für
  299. die Toleranz angeben.
  300.   Diese Option ist nur bei normalem Zeilenvergleich, nicht bei Binär-
  301. vergleich, verfügbar. 
  302.  
  303. Weiterhin ignoriert Égale auf Wunsch führende Leerzeichen, TABs und 
  304. ASCII-0-en. Und: Égale vergleicht auf Wunsch ohne Beachtung der
  305. Groß/Kleinschreibung.
  306.  
  307. Wie sie markiert werden sollen, können Sie einstellen, wenn Sie den
  308. Menüpunkt "Markierung..." anklicken. Es erscheint ein Dialog, indem
  309. man verschiedene Möglichkeiten wählen kann:
  310.  
  311. aus:        Schaltet die Hervorhebung aus
  312.  
  313. Rest grau:  die wohl beste Option. Alles, was nicht gesucht wird,
  314.             wird durch graue Schrift gekennzeichnet.
  315.  
  316. fett:       Alles, was gesucht wird, wird fett dargestellt.
  317.  
  318. ausblenden: Alle nichtgesuchten Zeilen werden ausgeblendet.
  319.  
  320. Trennstrich:Hier wird der Trennstrich zwischen den nicht gesuchten
  321.             Zeilen gelöscht. So kann man auch sehr schnell Unter-
  322.             schiede oder Gleiches finden.
  323.  
  324. Zeichenweise
  325. markieren:  Mit dieser etwas abweichenden Option werden die Zeilen
  326.             zeichenweise überprüft und die zu suchenden Zeichen mit
  327.             einem Grauraster unterlegt. Man kann so sehr schnell 
  328.             sehen, was sich verändert hat.
  329.               Unter diesem Button befindet sich ein PopUp-Menü, bei 
  330.             dem weitere Optionen ausgewählt werden können, welche 
  331.             nur aktiv sind, wenn "Zeichenweise markieren" angewählt 
  332.             ist. "Erstes Gesuchtes" markiert innerhalb einer Zeile 
  333.             immer das erste Zeichen, das unterschiedlich (bzw. 
  334.             gleich) ist. Es wird immer nur ein Buchstabe selektiert. 
  335.             "Alles" sorgt dafür, daß Égale alle Zeichen zweier 
  336.             Zeilen einzeln vergleicht und dann alle Zeichen 
  337.             markiert, die unterschiedlich (bzw. gleich) sind. Diese 
  338.             Option macht nur Sinn, wenn in einer der Dateien nur 
  339.             Zeichen geändert, nicht aber eingefügt wurden. 
  340.               "Einfügungen" ist die intelligenteste, aber auch 
  341.             langsamste Einstellung. Égale stellt im Vergleich beider 
  342.             Zeilen fest, wo Textstücke eingefügt wurden. Diese 
  343.             Textstücke werden markiert; werden Übereinstimmungen 
  344.             gesucht (Dialog "Vergleichsmodus"), wird die ganze Zeile 
  345.             bis auf die Einfügung markiert. Auch diese Option eignet 
  346.             sich nicht für alle Dateien. Der dazu 
  347.             verwendete Algorithmus ist nicht ganz einfach und kann 
  348.             also auch nicht allzuschnell sein. Schließlich ist hier 
  349.             eine gewisse Eigenintelligenz vom Computer gefordert. 
  350.             Und da diese bei Computern nur sehr spärlich vorhanden 
  351.             ist, kann Égale auch nicht immer alles korrekt erkennen.
  352.  
  353. -> Vorsicht: Der Dialog erscheint nur, wenn Égale registriert wurde.
  354.              Ansonsten können Sie nur zwischen "aus" und "Rest grau"
  355.              wählen.
  356.  
  357. Égale kann außerdem die Zeilen fortlaufend numerieren. Dazu dient der
  358. Menüpunkt "Zeilennummern".
  359.  
  360. Sie können sich in Égale auch eine der zwei Dateien einzeln betrach-
  361. ten. Dazu drücken Sie die Tastenkombination CTRL-<Pfeil links>
  362. (rechter Text) bzw. CTRL-<Pfeil rechts> (linker Text). Mit "SPACE"
  363. können Sie wieder in den Dateivergleichsmodus zurückschalten.
  364.  
  365. Weiterhin besteht die Möglichkeit, den rechten Text weiter nach
  366. links oder rechts zu verschieben.
  367.   Um also die Trennlinie zu verschieben, drücken Sie die Pfeiltasten:
  368. <Pfeil links> verschiebt die Trennlinie nach links,
  369. <Pfeil rechts< verschiebt die Trennlinie nach rechts.
  370. Wenn Sie zusätzlich noch Shift drücken, wird die Trennlinie in
  371. kleinen Schritten verschoben !
  372. Wenn Sie zu der Pfeiltaste Control drücken, wird die Trennlinie ganz
  373. an den Rand geschoben, s.o. Dann kann die Trennlinie übrigens nur
  374. wieder mit SPACE auf den Bildschirm gebracht werden !
  375.  
  376. Égale kann den Cursor, also das Zeichen, das die aktuelle Zeile
  377. markiert, in verschiedenen Arten darstellen. Das läßt sich im Dialog
  378. "Darstellung" einstellen. Die verschiedenen Formen dienen dazu, die
  379. Sicht frei zuhaben, wenn man die Zeilen vergleichen möchte.
  380.   In diesem Dialog können Sie außerdem den Abstand zwischen den
  381. Tabulatoren festsetzen. Sie wird immer angewendet, wenn Égale auf
  382. einen Tabulator (ASCII 9) im Text trifft.
  383.   -> Dieser Dialog ist nur verfügbar, wenn Égale registriert wurde.
  384.  
  385.  
  386. 2.3 Das Menü "Suchen"
  387.  
  388. Hier können verschiedene Positionen in den geladenen Dateien ange-
  389. sprungen werden.
  390.  
  391. 2.3.1 Texte suchen
  392.  
  393. Mit dem Menüpunkt "suchen" kann man Textteile in den Dateien des
  394. aktuellen Fensters suchen. Dazu erscheint ein Dialog, in dem man die
  395. Dateien, in denen gesucht werden soll, selektieren kann und in dem
  396. man den zu suchenden String angeben kann. Sie haben die Möglichkeit,
  397. in der Textzeile den ASCII-Wert eines zu suchenden Zeichens anzu- 
  398. geben. Im Dezimalsystem genügt dabei eine einzelne Zahl, möchten Sie 
  399. das Hexadezimalsystem verwenden, stellen Sie einfach ein '$' vor den 
  400. Wert. Égale kann außerdem noch Binärzahlen ('&X' vor den Wert) sowie 
  401. Oktalwerte ('&O' oder '$' vor den Wert) umwandeln. Sie können auch 
  402. mehrere Werte angeben, diese werden dann mit einem Leerzeichen im 
  403. Eingabefeld getrennt. Wenn Égale die Zeichenkette als ASCII-Wert(e) 
  404. interpretieren soll, müssen Sie "ASCII-Wert" selektieren.
  405.   Außerdem besteht die Möglichkeit der Groß/Klein-sensitiven Suche, 
  406. d.h. Égale kann die Groß/Klein-Schreibung beachten. Mit "nächsten" 
  407. springt man zur nächsten gefundenen Textstelle.
  408.  
  409. 2.3.2 Springen
  410.  
  411. Égale bietet die Möglichkeit, im Text nach Belieben (zeilenweise) zu
  412. springen. Es erscheint ein Dialog, in dem man zwischen absolutem und
  413. relativen Springen wählen kann.
  414.   Bei absolutem Springen gibt der einzugebende Wert die Zeilennummer
  415. an, zu der gesprungen werden soll.
  416.   Bei relativem Springen gibt der Wert die Anzahl Zeilen an, die ge-
  417. sprungen werden soll. Hier können dann auch negative Werte zum rück-
  418. wärtsspringen stehen.
  419.  
  420. 2.3.3 Zeilenabgleich
  421.  
  422. Mit dieser sehr nützlichen Funktion kann man schnell Einfügungen
  423. oder Löschungen von Textpassagen oder mehreren Zeilen vornehmen, die
  424. in einem der beiden Texte vorgenommen wurden. Das funktioniert so:
  425. Nehmen wir an, Sie hätten links eine alte Version einer Datei, und
  426. auf der rechten Seite wurden ca. 8 Zeilen an einer Stelle in die
  427. Datei eingefügt. Jetzt kann Égale die erste Zeile der linken Datei,
  428. wo rechts die Einfügung beginnt, in der rechten Datei suchen und
  429. weiß somit schnell über die eingefügten Zeilen Bescheid. Zuerst
  430. werden sie gefragt, welche Zeile gesucht werden soll, also die linke
  431. oder die rechte. I.d.R. wird die Seite gegenüber der sein, in der
  432. eingefügt wurde. Wurden Zeilen gefunden, kann ein Zeilenabgleich
  433. stattfinden. Égale fragt vorher mit Angabe der Zeilendifferenz nach.
  434.   Den Zeilenabgleich kann man ganz schnell durch Drücken der rechten
  435. Maustaste erreichen, dann spart man sich die erste Abfrage; die Maus
  436. sollte sich dann aber über der zu suchenden Zeile befinden.
  437.   In der zweiten Abfrage existiert ein Button, bezeichnet mit 
  438. "Immer". Dieser sorgt dafür, daß die Alertbox nicht mehr erscheint 
  439. und dort immer Zeilen eingefügt werden. Man kann das Erscheinen der 
  440. Alertbox wieder anschalten, indem man beim Aufrufen der Funktion 
  441. Control oder Alternate drückt.
  442.  
  443. 2.3.4 Der automatische Zeilenabgleich
  444.  
  445. Mit dieser Funktion können die Dateien des aktuellen Fensters 
  446. aufeinander abgestimmt werden. Égale versucht dabei, an den 
  447. richtigen Stellen in der Datei Zeilen einzufügen (wie Sie es auch 
  448. mit INSERT machen können), um Übereinstimmungen zwischen den Dateien 
  449. zu erreichen. In etwa funktioniert dies so, als ob Sie per Mausklick 
  450. rechts auf die unterschiedlichen Zeilen einen manuellen Zeilen-
  451. abgleich auslösen würden.
  452.   Bevor die Funktion gestartet wird, können Sie in einem Dialog zwei 
  453. Parameter angeben: Zum einen ist dies die Anzahl an Zeilen, die 
  454. zusammenhängen müssen, damit Égale einen davor liegenden eingefügten 
  455. Zeilenblock erkennt. Alles klar ? Falls nicht:
  456.  
  457. Datei 1        Datei 2
  458. ----------------------
  459. AA             AA
  460. BB             BB
  461. CC             ##
  462. DD             ##
  463. EE             ##
  464. FF             CC          }
  465. GG             DD          }
  466. HH             EE          }
  467. II             ##          *
  468. JJ             FF
  469. KK             XX
  470.  
  471. In diesem Beispiel wurde die Datei 1 in einen Editor geladen und an 
  472. den mit ## markierten Stellen Zeilen eingefügt. Der Mindestanzahl-
  473. Parameter gibt nun die Anzahl der Zeilen an, die mit '}' markiert 
  474. wurden, damit Égale die eingefügten Zeilen in Datei 1 ausgleicht. 
  475. Stünde der Wert z.B. auf 2 oder 3, würde ein Abgleich stattfinden. 
  476. Stünde er jedoch auf 4 oder höher, würde Égale die Einfügung 
  477. ignorieren. In der mit '*' markierten Zeile würde nur dann ein 
  478. Abgleich stattfinden, wenn der Wert auf höchstens 1 stünde.
  479.   Mit dem zweiten anzugebenden Parameter läßt sich die maximale 
  480. Anzahl an Zeilen angeben, die auf einmal eingefügt werden sollen.
  481. Übertragen auf das obige Beispiel würde das bedeuten, daß wenn der 
  482. Wert auf 2 eingestellt wäre, kein Abgleich beim ersten Einfügeblock 
  483. stattfinden würde. Stellten Sie den Wert auf mindestens 3 ein, würde 
  484. alles abgeglichen werden.
  485.   Diese Funktion enthält einen ausgeklügelten Algorithmus, der die 
  486. meisten Dateien ordentlich abgleichen dürfte. Doch trotz Égale wird 
  487. Ihr Atari nicht zu einer selbstdenkenden Maschine. Und es kann - 
  488. insbesondere bei völlig verschiedenen Dateien - etwas länger dauern, 
  489. bis sich Égale wiedermeldet. Man sollte also selbst erstmal 
  490. überlegen, ob ein Aufruf dieser Funktion Sinn macht. Sollten zwei 
  491. völlig Unterschiedliche Dateien geladen sind, wird Égale vermutlich 
  492. auch mal 2 Stunden mit dem - nicht möglichen - Abgleich beschäftigt 
  493. sein. Macht aber ein Zeilenabgleich Sinn, geht dieser recht flott 
  494. (einige Minuten maximal) vonstatten.
  495.  
  496. 2.3.5 zur ersten gesuchten Zeile
  497.  
  498. Hiermit findet man die gesuchten Zeilen (entweder Unterschiede oder
  499. Gleiches, je nach Einstellung in "Vergleichsmodus"). Man kann zum
  500. ersten oder nächsten Unterschied bzw. zur ersten oder nächsten
  501. gleichen Zeile im Fenster springen.
  502.  
  503.  
  504. 2.4 Dateibearbeitung
  505.  
  506. Égale bietet einige Möglichkeiten, um die geladenen Dateien zeilen-
  507. weise zu verändern.
  508.  
  509. Hierfür ist der Zeilencursor entscheidend. Dieser wird durch einen
  510. schwarzen Balken dargestellt; er kann mit den Cursor-Pfeiltasten auf-
  511. und abbewegt werden.
  512.  
  513. Égale kann nun an dieser Stelle Zeilen einfügen und Zeilen löschen.
  514. Mit der Taste "Insert" lassen sich Zeilen einfügen, mit "Delete"
  515. löschen.
  516.   Diese Kommandos beziehen sich jeweils nur auf eine von beiden
  517. Dateien. Deshalb muß man zu "Insert" oder "Delete" noch eine Shift-
  518. Taste drücken. Drücken Sie die linke Shift-Taste, bezieht sich die
  519. Operation auf den linken Text; drücken Sie die rechte Shift-Taste,
  520. auf den rechten Text (wer hätte das gedacht ???).
  521.   Eingefügte Zeilen werden als hellgrauer Balken dargestellt. Die 
  522. Zeilennummerierung berücksichtigt Einfügungen und Löschungen.
  523.  
  524. Sinn des ganzen ist es, die Dateien besser vergleichen zu können:
  525. Oftmals besteht ja eine Verschiebung um eine Zeile: So wären alle
  526. Zeilen unterschiedlich.
  527.  
  528. Es kann pro Datei nur eine begrenzte (aber großzügig bemessene)
  529. Anzahl an Zeilen eingefügt werden.
  530.  
  531. -> Anzumerken ist, daß diese Funktionen nur vorhanden sind, wenn 
  532.    Égale registriert wurde.
  533.  
  534. Außerdem können Dateien automatisch mit der Funktion
  535. "Zeilenabgleich" aus dem Menü "Suchen" bearbeitet werden.
  536.  
  537.  
  538. 2.5 Abspeichern der Optionen
  539.  
  540. Mit dem Menüpunkt "Optionen"/"Einstellungen sichern" lassen sich die
  541. gemachten Einstellungen inklusive Suchtext u.ä. in einer Datei ab-
  542. speichern. Es werden auch Fensterpositionen und die Namen dergelade-
  543. nen Dateien gespeichert. Am Anfang des Programmes wird automatisch
  544. die Einstellungsdatei "EGALE.INF" geladen, sofern vorhanden.
  545.   Auch später können Sie Einstellungen mit dem Menüpunkt "Einstel-
  546. lungen laden" laden, wobei Sie gefragt werden, ob die abgespeicherten
  547. Fenster und Dateien anstatt oder zusätzlich geöffnet werden sollen.
  548.  
  549. 2.6 Fensterhandling
  550.  
  551. Um das Arbeiten mit Fenstern einfacher zu gestalten, gibt es einige
  552. Funktionen in Égale.
  553.  
  554. Datei/vertauschen
  555. vertauscht die beiden Dateien des aktuellen Fensters: Die Datei, die
  556. vorher links war, ist jetzt rechts und umgekehrt.
  557.  
  558. Datei/Information
  559. Zeigt einige Informationen über die Dateien im aktuellen Fenster:
  560. Namen, Dateilänge, Zeilenanzahl und Zeilendurchschnittslänge.
  561. Ist kein Fenster offen, wird eine allgemeine Information gezeigt.
  562.  
  563. _____________________________________________________________________
  564.  
  565. ***** 3. Start von Égale
  566.  
  567. Nein, hier steht jetzt nicht die Startanleitung für S-DAUs (Sehr
  568. dumme Anfänger-User) à la "Legen Sie die Égale-Diskette ein../..
  569. klicken Sie zweimal schnell mit der linken Maustaste auf das Égale-
  570. Programmsymbol...."
  571.  
  572. 3.1 Parameterübergabe
  573.  
  574. Wenn Sie Égale mit einer DOS-ähnlichen Shell aufrufen oder Égale per
  575. Desktop eine Kommandozeile übergeben, kann Égale diese auswerten.
  576.  
  577. Geben Sie die Namen der beiden Dateien an, die sie vergleichen
  578. wollen. Ein Pfad darf enthalten sein.
  579. Z.B.
  580.    EGALE dat_a.txt dat_b.txt
  581.  
  582. Damit entfällt der automatisch erscheinende Fileselektor zu Beginn
  583. des Programms.
  584.  
  585. Um Tipparbeit zu sparen, können sie Wildcards '*' und '?' benutzen.
  586. Égale sucht sich dann selbstständig die Dateien, die auf das Eingabe-
  587. muster passen.
  588.  
  589. Wenn beide Namen dasselbe Suchmuster haben, kann der zweite Namen
  590. weggelassen werden. Beispiel:
  591.  
  592.  EGALE erg?.dat      vergleicht die Dateien ERGA.DAT   und ERGB.DAT
  593.  EGALE TEXT*.DOC     vergleicht die Dateien TEXT_1.DOC und TEXT_21X.DOC
  594.  
  595. Die Dateiangaben können auch einen Pfad enthalten. Sind zwei Dateien
  596. gleichen Namens in unterschiedlichen Ordnern zu vergleichen, so
  597. reicht beim zweiten Namen die Angabe des Ordners. Z.B. vergleicht
  598.  
  599.   EGALE \tex\brief.tex \tex\doc\
  600.  
  601. die beiden Dateien
  602.  
  603.   \TEX\BRIEF.TEX  und \TEX\DOC\BRIEF.TEX
  604.  
  605. Hinweis: Égale findet bei Angabe eines Suchmusters nur die jeweils
  606. ersten passenden Dateien im betreffenden Ordner. Sind mehr Dateien
  607. vorhanden, auf die das Muster zutrifft und wählt Égale nicht die
  608. gewünschten aus, so muß das Muster evt. genauer angegeben werden.
  609.  
  610. Es besteht außerdem die Möglichkeit, einmal nur einen Dateinamen an-
  611. zugeben, der Pfad wird dann von der anderen Datei übernommen, z.B.:
  612.  
  613.   EGALE \tex\dat_a.txt dat_b.txt
  614.  
  615. Achtung: Der Dateinamen darf nicht mit '*' beginnen.
  616.  
  617. _____________________________________________________________________
  618.  
  619. ***** 4. Tips zur Benutzung
  620.  
  621. Die wohl sinnvollste Markierungseinstellung ist wohl "Rest grau", da
  622. sieht man sehr schnell, wo die Unterschiede bzw. gleichen Zeilen lie-
  623. gen. Nur: leere Zeilen werden nicht markiert.
  624. Hier hat es sich bewährt, die Zeilennumerierung einzuschalten !
  625. Auch die Optionen zum Erkennen des ersten Unterschieds innerhalb von 
  626. Zeilen haben sich als sehr praktisch erwiesen (-> nur in der 
  627. registrierten Version !)
  628.  
  629. _____________________________________________________________________
  630.  
  631. ***** 5. Sonstiges
  632.  
  633. Gedankt sei den Betatestern:
  634. Rainer Albrecht, Aleks Almonacid-Lessmann, J.Jørgen von Bargen, 
  635. Werner Herrmann, John Mcloud, Robert Schaffner, Arndt Weinmann,
  636. Ralf Zimmermann
  637.  
  638. Wir - Christof Schardt und David Reitter - wünschen Ihnen viel
  639. Erfolg bei der Benutzung von Égale.
  640.  
  641. Mainz, 9.10.93
  642.  
  643.